<?xml version='1.0' encoding='utf-8' ?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
	<head>
		<meta http-equiv="Content-Type" content="text/html; charset=utf-8"/>
		<title>3.6. How to detach viewpoints</title>
		<link type="text/css" rel="stylesheet" href="PLUGINS_ROOT/org.polarsys.capella.doc/html/styles.css"/>
	</head>
	<body>
		<h1 id="How_to_Detach_Viewpoints_from_Capella_Project.3F">How to Detach Viewpoints from Capella Project?</h1>
		<p>Capella enforces the presence of all the Viewpoints used by a project. Thus it is mandatory to install all these Viewpoints in Capella in order to migrate or to open a project.</p>
		<p>When all the Viewpoints previously used by the project are installed in the Capella target version, the migration will work as expected. In this scenario, the Detachment tool is not needed.</p>
		<p>If the Viewpoints are not available nor installed in the Capella target version, a preparation of the project is needed before the migration will be possible.</p>
		<p>Two cases can be faced.</p>
		<table border="1">
			<tr>
				<td>
					<p>
						<img height="34" width="34" border="0" src="Images/3.6.%20How%20to%20detach%20viewpoints_html_723ed3f9.png"/>
					</p>
				</td>
				<td>
					<p>
						<b>It&rsquo;s highly recommended to manually backup you</b>
						<b>r project before using the tool.</b>
					</p>
				</td>
			</tr>
		</table>
		<p>
			<br/>

			<br/>
		</p>
		<h2 id="The_Viewpoints_are_Available_and_Installed_in_the_Source_Version">The Viewpoints are Available and Installed in the Source Version</h2>
		<p>In this case, it&rsquo;s recommended to :</p>
		<ul>
			<li>Open the project in the Capella source version of the project.</li>
			<li>Deselect all the unavailable viewpoints of the target version, by using the &ldquo;Viewpoint Selection&rdquo; contextual menu.</li>
			<li>Save the project.</li>
			<li>Uninstall the Viewpoints from the Capella installation.</li>
			<li>Launch the Detachment tool by using the &ldquo;Viewpoint Detachment&rdquo; contextual menu.</li>
		</ul>
		<p>
			<img border="0" src="Images/3.06_Detach_Viewpoint3.png"/>
		</p>
		<p>Fig. Launching Viewpoint detachment wizard</p>
		<h2 id="The_viewpoints_are_not_available_and_installed_in_the_source_version">The viewpoints are not available and installed in the source version</h2>
		<p>In this case, while the openning of the project the following Pop-up windows will appear:</p>
		<p>
			<img border="0" src="Images/3.06_Detach_Viewpoint4.png"/>
		</p>
		<ul>
			<li>Once you clicked on "
				<i>OK</i> "  you can directly launch the Detachment tool by using the &ldquo;Model Detachment&rdquo; contextual menu.
				<br/>
				<i>Remark: The &ldquo;Model Detachment&rdquo; contextual menu is only available when your project is closed .</i>
				<br/>
			</li>
			<li>The Detachment tool will analyse the project model and list all unknown elements (Viewpoints) and unresolved resources (Libraries).
				<br/>
				<br/>
				<ul>
					<li>If some unknown elements are detected, they will be listed in the 
						<i>Unknown references</i> menu and you could use the &ldquo;Launch Detachment&rdquo; button. This action will remove all the unknown elements from the project. 
						<br/>
						<br/>
						<img border="0" src="Images/3.06_Detach_Viewpoint2.png"/>
						<br/>
						<br/>
						<br/>
					</li>
					<li>If some unresolved resources are detected, they will be listed in the 
						<i>Model resource/Unknown resources</i> menu and you could use the &ldquo;Launch Detachment&rdquo; button. This action will remove all the wanted unresolved resources from the project by 
						<b>deselecting them</b> . 
						<br/>
						<br/> 
					</li>
				</ul>
			</li>
		</ul>
		<p>
			<img border="0" src="Images/3.06_Detach_Viewpoint5.png"/>
		</p>
	</body>
</html>